Grundlegende Informationen zur Struktur eines Manifests im JSON Schema Format
Für die Erstellung eines Manifests für Ihre App im JSON Schema Format können Sie einen einfachen Texteditor verwenden. Mit dem Tool eines Drittanbieters, z. B. https://jsonlint.com, können Sie Ihre Formatierung anschließend überprüfen.
Das allgemeine Format eines App-Manifests ähnelt dem Manifest im JSON Schema Format, das auf der folgenden Website aufgeführt ist:
https://support.google.com/chrome/a/answer/9771882
Die offizielle Dokumentation sowie weitere Informationen zu JSON Schema finden Sie auf der folgenden Website:
https://json-schema.org
Anwendungseigenschaften
Ein App-Manifest umfasst eine Kopfzeile gefolgt von einer Liste der Anwendungseigenschaften. Jede Eigenschaft besteht aus einem Schlüssel-Wert-Paar. Wenn Sie diese Schlüssel-Wert-Paare festlegen und das Manifest zu Jamf Pro hochladen, wird auf der Jamf Pro Benutzeroberfläche automatisch eine benutzerfreundliche Ansicht der Eigenschaftsliste erstellt, damit Sie die App einfach anpassen können.
Jede Eigenschaft, die für das im JSON Schema Format erstellte Manifest definiert wird, umfasst die folgenden Elemente:
-
Key Name – Dies ist der Name der Eigenschaft.
-
title – Hiermit wird der Name der Eigenschaft definiert.
-
description – Hiermit wird die Beschreibung der Eigenschaft festgelegt.
-
property_order – Hiermit wird die numerische Reihenfolge der Eigenschaft in der Liste in aufsteigender Sortierung festgelegt. Niedrigere Zahlen werden zuoberst angezeigt.
-
type – Hiermit wird der Wertetyp der Eigenschaft festgelegt (z. B. „integer“ [Ganzzahl]).
Eine Liste der verschiedenen Wertetypen und Informationen zu ihrer Verwendung in Jamf Pro finden Sie unter Anhang: Konfigurierbare Einstellungen.
In der folgenden Tabelle ist beispielhaft ein im JSON Schema Format erstelltes Manifest für die Beispiel-App „Disk Manager“ aufgeführt. Dieses ist in eine Kopfzeile und mehrere Anwendungseigenschaften unterteilt. In den einzelnen Tabellenzeilen wird aufgezeigt, wie eine Formularseite erstellt und wie diese in Jamf Pro dargestellt wird.
|
Anwendungseigenschaft |
Schlüssel-Wert-Paar |
In Jamf Pro generierte Einstellung |
|
Kopfzeile |
{ "title": "Disk Manager (net.talkingmoose.diskmanager)", "description": "Preference settings for the Disk Manager application", "properties": { |
Die Kopfzeile enthält den Titel des Manifests und eine Beschreibung. Sie umfasst darüber hinaus nützliche Informationen, z. B. die App-Domäne (Bundle-Kennung). |
|
Eigenschaft 1 |
"askForPasswordDelay": { "title": "Ask For Password Delay", "description": "Disk Manager will wait the selected amount of time before requiring a password.", "property_order": 5, "type": "integer", "options": { "enum_titles": ["immediately", "5 seconds", "1 Minute", "5 Minutes", "15 Minutes", "1 Hour", "4 hours", "8 hours"] }, "enum": [0,5,60,300,900,3600,14400,28800] }, |
Bei dieser Eigenschaft wird für type der Wert integer festgelegt. Zudem werden vordefinierte Optionen für die Eigenschaft angegeben, die durch das Schlüssel-Wert-Paar enum_titles festgelegt werden. Wenn für das Schlüssel-Wert-Paar enum_type Werte angegeben werden, wird mit dieser Einstellung von Jamf Pro anhand der Werte ein Einblendmenü mit den zugehörigen Optionen erstellt. |
|
Eigenschaft 2 |
"diskCacheSize": { "title": "Disk Cache Size", "description": "Set disk cache size, in bytes.", "property_order": 10, "type": "integer" }, |
Bei dieser Eigenschaft wird für type der Wert integer festgelegt, es werden jedoch keine vordefinierten Optionen angegeben. Mit dieser Einstellung wird von Jamf Pro ein Textfeld erstellt, in das eine Ganzzahl eingegeben werden kann. |
|
Eigenschaft 3 |
"primaryServer": { "title": "Primary Server", "description": "Disk Manager will default to this server.", "property_order": 15, "type": "string", "options": { "enum_titles": ["Server 1", "Server 2", "Server 3"] }, "enum": ["https://server1.talkingmoose.net/", "https://server2.talkingmoose.net/", "https://server3.talkingmoose.net"/] }, |
Bei dieser Eigenschaft wird für type der Wert string festgelegt. Zudem werden vordefinierte Optionen als Werte für die Eigenschaft angegeben, die durch das Schlüssel-Wert-Paar enum_titles festgelegt werden. Wenn für das Schlüssel-Wert-Paar enum_type Werte angegeben werden, wird mit dieser Einstellung von Jamf Pro anhand der Werte ein Einblendmenü mit den zugehörigen Optionen erstellt. |
|
Eigenschaft 4 |
"downloadDirectory": { "title": "Download Directory", "description": "Choose the default location for downloading working files.", "property_order": 20, "type": "string" }, |
Bei dieser Eigenschaft wird für type der Wert string festgelegt, es werden jedoch keine vordefinierten Optionen angegeben. Mit dieser Einstellung wird von Jamf Pro ein Textfeld erstellt, in das Text eingegeben werden kann. |
|
Eigenschaft 5 |
"askForPassword": { "title": "Ask For Password", "description": "Set Disk Manager application to require a password.", "property_order": 25, "type": "boolean" }, |
Bei dieser Eigenschaft wird für type der Wert boolean festgelegt. Mit dieser Einstellung wird in Jamf Pro ein Einblendmenü angezeigt, in dem zwischen den Optionen „true“ und „false“ gewählt werden kann. |
|
Eigenschaft 6 |
"domainSafeList": { "title": "Domain Safelist", "description": "Disk Manager will not filter these domains.", "property_order": 30, "type": "array", "items": { "type": "string", "title": "Domain" } }, |
Bei dieser Eigenschaft wird für type der Wert array festgelegt. Zudem wird für die Elemente des Arrays der Typ string festgelegt. Mit dieser Einstellung wird von Jamf Pro eine Liste mit einem oder mehreren Textfeldern erstellt, in die Daten eingegeben werden können. |
|
Eigenschaft 7 |
"serverList": { "title": "Server List", "description": "Add servers to management list.", "property_order": 35, "type": "array", "items": { "type": "object", "properties": { "serverAddress": { "title": "Hostname", "type": "string" }, "macAddress": { "title": "MAC Address", "type": "string" }, "ipAddress": { "title": "IP Address", "type": "string" } } } } |
Bei dieser Eigenschaft wird für type der Wert array mit einem oder mehreren Schlüsselverzeichnissen festgelegt, von denen jedes Untereigenschaften enthält, für die der Typ string festgelegt wird. Mit dieser Einstellung wird von Jamf Pro eine Liste von Textfeldern erstellt, in die für mehrere Elemente in der Liste Informationen eingegeben werden können. Ob zusätzliche Felder in der Liste aufgeführt werden, ist davon abhängig, wie viele zusätzliche Untereigenschaften festgelegt werden. Hinweis: Bei der letzten Eigenschaft im Manifest entfällt das Komma als Trennzeichen hinter der schließenden geschweiften Klammer („}“). |
Jamf Pro Benutzeroberfläche
Nachdem Sie das im JSON Schema Format erstellte Manifest zu Jamf Pro hinzugefügt haben, wird auf der Jamf Pro Benutzeroberfläche automatisch eine benutzerfreundliche Ansicht der Eigenschaftsliste erstellt, damit Sie die App einfach anpassen können. Der folgende Screenshot zeigt beispielhaft eine solche Ansicht:
